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Addendum 

FKAiSOC tm;> /// 
t'j e 1 c: om «e* -s- 

t h <=• p* p* 1 e Dot T'-l 3. t n i X R r- i n t •=■ r- 

November 1982 
Sof twar e revision 3.1 

PKASO /// has been updated to support the PKA30 AP12 tor the Apple 
Dot Matrix Printer < DMP) providing all ot the teatures ot the 
PKASO ///. The Apple DMP is almost identical to the NEC PC-8023 
and C.itoh Pro/Writer printers, and has been implemented as an 
enhanced variety ot this species. Familiarize yourself with the 
PKASO /// manual and refer to the sections pertaining to these 
printers for specific PKASO features and commands available on the 
DMP. 




S v=- t e-m C o n -f= i Q u n 3. t i o n L_: h 3 ri q e- 

To install your PKASO driver for use with the Apple DMP, follow 
the instructions as described in Appendix D of your PKASO /// 
manual. The following changes have been made to the Driver- 
Conf i gur a t i on Block to support the Apple DMP; 



Byte 0 



Printer type. 

Set to — > 07 < — for NEC, C.itoh or Apple DMP. 



Byte A Printer Sub- type. 

Set to --> 0 4 <: — for Apple DMP. 

The definition of all other bytes remains the same. 

S LJ p> p« o r- t e* cd C h 3 r- 3 c: t: e r S i 2: e* =- 

PKASO / V for the Apple DMP supports three character sizes and 
their expanded sizes. These sizes are 10, 12, and 17 characters 

per inch. Also the 160 dots per inch proportional size and its 
expanded size are supported using the "E3, and ~E 1 1 , 
c ommands . 
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Addendum 



PKASO and PFS Graph 111 

Yes, you can print PFS Graphs with PKASO! 



These are graphs from PFS Graph for Apple III done with PKASO. 

As follows: 

Method A: (You need the Apple III Pascal system) Save the pictures, then use our PRINTPIX or 
PRINTCLR routines. 

1 . Save the pictures from PFS (option 4 get/save, then option 3 save picture). 

2 . Boot your Pascal III system. 

3 . X) execute PRINPIX or PRINCLR if you have a color printer. These programs are on our 
PKASO III disk. 

4 . Print with any of our options. 

Method B: Use the print routines built into PFS Graph (good for most printers). 

1 . Install our MINI DRIVER on your PFS disk following the installation instructions in your 
PKASO manual. 

2 . Use PFS' print features. 

Unfortunately, PFS uses bidirectional print and offers only 2 sizes. You can correct the bidirectional problem in most 
printers. Use the appropriate codes to select unidirectional printing in a PFS set-up string. 



Using PRINTPIX from the PKASO disk 



TAR6ET AND FORECAST 




MONTH 

■ TARGET m FORECAST 



Using PFS’ print routine with After defeating bidirectional on the 

Bi-Directional "jitter” NEC with ESCAPE < 

MAY SHIPMENTS BY REGION MAY SHIPMENTS BY REGION 




REGION REGION 

■ CABERtCT ra CHABLIS ■ CABERNET ^ CHABLIS 

□ ZINFANDEL K3 CJHAP.DONNAY Q 2INFANDEL E3 CHARDONNAY 
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COPYRIGHT NOTICE 

THE SOFTWARE AND DOCUMENTATION CONNECTED 
WITH THIS PRODUCT ARE COPYRIGHTED AND ALL 
RIGHTS ARE RESERVED. No portion of the product 
may be copied, translated, or reproduced in any 
fashion for use by or sale to any individual or 
firm other than the original purchaser. Due to 
the proprietary nature of the techniques used, 
any unauthorized attempt to copy any portion of 
the product will be treated under the Copyright 
Law of the United States, and may result in both 
civil and criminal penalties and imprisonment . 
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PRINTER INTERFACE AND DRIVER 
Apple /// Operating Manual 

IMTROOUCTION 

You are now the proud owner of a PKASO Cm) 

Printer Interface System, the first and most 
powerful interface system available for matria 
printers and the Apple III microcomputer. 

The PKASO Apple /// software package includes 
this manual and an Apple III software diskette. 

It works in conjunction with the PKASO interface 
card, and provides complete support for Apple III 
in both Native and Emulation modes . 

This manual includes a QUICK REFERENCE 
summarizing the operation of the PKASO system. 
<Appendix A) 

A fold-out command chart at the end of this 
manual includes the details, sizes, and 
eccentricities of your printer . 

WHAT YOU HEED . . . 

C. Itoh 8510, 

A matrix printer: Centronics 739 or 122 , 

(See Appendix F> Epson MX70 , 80, or 100, 

IDS Prism, 560, or 460, 

NEC PC8023A-C, 

Okidata 82A, 83A. 

The PKASO III system is designed for Apple III 
with at least 128K of memory . 

GETTIHC STARTED . . . 

If you*re experienced with the Apple III , here is 
a quick startup procedure: With all power OFF, 

plug the interface card into slot 1 and connect 
the cable to the printer. Use SCP to install 
PKASO . DRIVER (from the PKASO Diskette) onto your 
bootable diskette as . PRINTER . Set byte 0 of its 
DCB to the proper number for your printer. Then 
RUN PRINTPIX (from the PKASO Diskette). PRINTPIX 
lets you load FOTO files and print them. 
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E'EATURES 
OF THE PKASO SYSTEM 

The PKASO Interface System is designed to smooth 
out the rough spots in using a printer and a 
computer together . It will make routine 
operations easier, and it will add entra 
capabilities to the system. 

^S A simple language for easily controlling 
printer features from any program . 

«S HiRes Screen Print with your choice of 
size, rotation, and style. 

3 Choice of 2 HiRes print modes for: (A> 

graphing , or CB) shaded images . 

SoftFont <Tm> Character Mode lets 
you print all teat using the present screen 
character style . 

IS Text screen snapshot print, 40 or 80 
columns, can print with the same character style 
you see on the screen . 

HalfTone Gray Scale mode lets you print 
with 16 levels of gray. 

«S SuperRes Gm> Dot graphics, lets you 
print dot graphics directly from any program . 

SS Visible signal on screen when the printer 
is off line or out of paper . 

nS Easy-to-use Tabs for indentation and 
column printing . 
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Tisisnr AIL.il 

A . THE INTERFACE CARD . . . 

First , TURN OFF your Apple and your printer! 

The PKASO interface system includes an interface 
electronics card and a cable . The gold edge 
connector of the card plugs into one of the I/O 
Eapansion Slots located inside the case of the 
Apple, on the rear portion of the processor 
board. <Your Apple /// manual gives all the 
details on this . > 

The customary location for a printer is eapansion 
Slot 1 , the leftmost slot as you look from the 
front of the machine. The PKASO Driver and the 
eaamples in this manual are designed for a PKASO 
card in Slot 1 . 

Plug the interface card firmly into the Slot, 
with the cable eatending out one of the openings 
in the back of the Apple cabinet. Plug the PKASO 
cable connector into the matching connector at 
the rear of the printer . 

Turn the printer power on . <Consult your printer 
manual for the proper way to do this, how to make 
sure it worked, and what to do if it didn't.) 

The printer is now ready to print and is awaiting 
data from the Apple . 
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B. THE SOS DRIVER. . . 

Part of the PKASO system when running in Apple 
/// native mode is a software module called a 
Driver. The driver is in charge of accepting 
data from the language interpreter or application 
program you are using, and transmitting it 
properly to the printer . 

The driver must first be installed (the software 
equivalent of plugging it in) on your boot 
diskette. It then becomes part of your SOS 
configuration and is ready to perform whenever 
printing is requested. Apple gives you very 
complete instructions for doing the installation 
in the Standard Device Drivers manual . APPENDIX 
D OF THIS MANUAL GIVES THE FULL PROCEDURE. 

Briefly, you run the System Configuration Program 
(SCP) and follow its instructions. First set the 
printer slot to 1 . Delete any other printer 
drivers ( PRINTER, QUME, or SILENTYPE.) When 
SCP asks for a driver file, insert the PKASO 
Apple /// disk in drive 1 and enter the name 
PKASO. DRIVER. 

DCB 

THE DRIVER CONFIGURATION BLOCK 

The driver contains a Driver Configuration Block, 
(DCB) which specifies how the printer options 
will be set when you OPEN the printer for the 
first time or whenever you send a PKASO SOFT 
RESET command to the printer . The full 
description of the DCB is in Appendia E. These 
settings are default conditions and can of course 
be changed later by PKASO commands. 
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The first time through the startup procedure, 
just make 2 changes to the DCB: 

1 . Set the printer type , byte 0 , to the proper 
number for your printer. CSee Appendix E> 

2. Set the printer sub~type, byte 10, to 0 for 
8.5** wide paper, or to 1 for 13.9** paper. 

As you become familiar with the options in the 
DCB, you may want to re— adjust them (using the 
SCP program) so that the printer always comes up 
with your most convenient settings for the 
software in use . 

PRINTIMG FROM A PACKAGE 

The PKASO Driver follows Apple /// printer 
conventions and allows your matrix printer to be 
used by any software which requests printing . 

All you need to do is install the PKASO system, 
and you have a 10 character-per-inch printing 
capability . If you have a package which needs 
only rudimentary printing capability without 
commands or graphics, you can install MINI. DRIVER 
instead of the full PKASO . DRIVER . (See Appendix 
C .) 

This manual includes a section on Hints for use 
with popular languages and software, as well as a 
complete dump procedure for Apple Business 
Graphics . 
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BUSIIMESS BASIC 

If you want to enter printing commands at tKe 
keyboard or write a Business Basic program which 
prints, it*s simple. Just OPEN the printer, 
PRINT, then CLOSE it. 

OPENING. . . 

The OPEN step informs Basic that you wish to 
print and (if it hasn't been done yet) 
initializes the printer driver. Here is an 
esample of how this is done: 

OPEN #1, PRINTER from command level, or 
10 OPEN #1, " PRINTER" from a BASIC program. 

Refer to the sections on FILES and FILE I/O in 
your Business Basic manual for specifics on the 
OPEN command . 

PRINTING. . . 

Once the printer has been OPENed it is ready for 
use . There are two ways to access the printer: 
PRINT# and OUTPUT#. 

Method one is to use the PRINT# statement: 

PRINT #l;"PKASO" from command level, or 
20 PRINT #l;"PKASO" from a program. 
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The second method uses the OUTPUT# statement . 
Once this statement has been used, all output 
from PRINT, TRACE, and LIST statements and the 
SOS CATALOG command will be printed on the 
printer instead of the video screen. 

30 OUTPUT #1 

40 PRINT ‘'THIS GOES TO THE PRINTER" 

To switch output back to the video screen, 

50 OUTPUT #0 

60 PRINT "THIS GOES TO THE SCREEN" 

Printer output is switched off whenever the 
program terminates abnormally . 

CLOSING. . . 

Once you have finished using the printer you must 
CLOSE it. This is done as follows: 

70 CLOSE #1 



F ASC AL 

The printer appears to the PASCAL System to be 
the same as a text file. The PASCAL 
documentation, particularly the Programmer's 
Manual, contains a good discussion on the use of 
printers . To set up the file: 

VAR PR:TEXT; 

To open the file: 

REWRITE (PR , • . PRINTER*) ; 

Then use WRITE or WRITELN to PR to print. 
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PRINTER STATUS 

If you try to print with the printer in local 
mode or out of paper, a blinking message will 
appear in the lower right corner of the video 
screen. The PKASO Driver will then wait until 
printing is possible . 

This is a "non-destructive" display, and anything 
printed in that location will be replaced when 
the condition is remedied . If you have switched 
to a full-screen graphics display , you will not 
see the message, since it is displayed on the 
teat screen only . 

This, however, brings processing to a standstill 
since nothing will happen until the printer is 
ready. To prevent this, PKASO lets you check the 
status of the printer before trying to print . 

You can then prompt the user , come back later and 
try again, etc. 

Appendia 6 gives the details of Status Calls . 
Briefly, OPEN the printer, then make a Status 
Call to the PKASO Driver, as follows: 

INVOKE REQUEST. INV <on Bus . Basic 1.1 disk) 
PERFORM STATUS <%3 , ©STATUSLIST$) " . PRINTER" 
PRSTATUS = ASC<MID$<STATUSLIST$,5,1)> 

Performing STATUS fills your string (STATUSLIST) 
with information about the printer . The Sth 
character is the ready indicator . If PRSTATUS is 
0 , the printer is ready . (1 is off-line , 2 is 

paper-out , 3 is both . ) 

For the corresponding procedure in Pascal, see 
Appendia H of the Standard Device Drivers Manual . 
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PKASO COMMAMOS 

There are two types of information you need to 
send to a printer: 

1. PRINTABLE information, and 

2. CONTROL information, which does not 

produce any printing, but instructs 
the printer to change sizes & options. 

To send CONTROL information to the printer and 
the PKASO system, a miniature language has been 
designed called the PKASO III Command Language. 

It is an enhancement to, and in some cases a 
replacement for the standard ASCII control 
character set which includes Carriage Return, 

Form Feed, etc. 

PKASO Command = 

<"*'> <Command Char> <Option, ... Option, > 

The "" Lead-in character is how the PKASO 
system identifies a command . The is 
completely printable and can be sent from within 
any program . 

The Command Characters are ordinary printable 
characters as given in the description of each 
command . 

Options will usually be just decimal numbers, but 
may also be given in Literal or HeKadecimal form. 
The description of each command gives the type 
and number of options required. You should 
FOLLOW ALL OPTIONS, INCLUDING THE 
LAST ONE, WITH A SINGLE COMMA, as shown above. 
(This insures that PKASO sees the end of each 
option and does not attach the last one to any 
numbers you may be printing nent . ) 
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OPTION FORMAT 

In sending the Options part of a command, you 
have your choice of three ways to express 
yourself: 

<a.) Decimal Numbers, 0 thru 255, using the 
digits <0123456789>, 

(b . > Hexadecimal Numbers , $0 thru $FF , using 
the digits <012345689ABCDEF> preceeded by a 
Dollar Sign, $. 

Cc.) Literal Characters, any single ASCII 
character preceeded by a *' Grave Accent", 

For example, some valid Option strings are: 

1,2,3, 22,$7F, 'X,'y,2, 255, 

The following are not valid: 

1,2,3 22$7F, 'Xy,2, 256 

(No disaster will occur, but you may get 
surprising results.) 

The PKASO Command interpreter does not require 
that you use the comma as a separator for 
Options . You can use any character which 
unambiguously separates the items . You may prefer 
to use a space, asterisk, or any other character 
which PKASO will not interpret as another Option . 
Our convention is the comma, and examples in this 
manual will use commas . 

For example, to select compressed (16.5 char, per 
inch) printing, print "'*"£2,". This style of 
command can be used in the middle of word 
processing text, or even in a label field in 
Visicalc, for bold titles, etc. 
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ALTERNATE COMMAND FORMS 

A. CHANGING TO SOMETHING ELSE... 

The * lead-in character was chosen to denote 
PKASO Commands because it is printable j yet 
uncommon in ordinary printing. To change the 
lead-in to another character instead, you can 
(a . ) Change DCB byte 9 to the code for your 
desired lead— in character , such as $B3 for a # , 
or Cb.> Use the following PKASO Command: 



LEAD- 


IN Cmd : 


Changes Command Lead-in. 




F o rma t ; 


"'0<NewCode> , 




Ctrl 


Cha r Form; 


0 




F r om 


Basic : 


PRINT "~0" ;NEWC0DE ; ; 




F r om 


Pascal : 


WRITE (PR, ■ ~0' , NEWCODE, ' , ' 


) ; 



For eaample, you could use '*"0$B3, or '*'0'*# 
to change the lead-in to #, then #0$FE, or 
to change it back to . 

The Option NewCode should be one of the ASCII 
code numbers 32 thru 127 . A NewCode of rero 
disables the Lead-in Character processing of 
PKASO, and only the Control Character form of 
commands will be recognized. <See the nest 
section . ) 
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B. CONTROL CHARACTER FORM... 

An alternate command format is also included 
which is more concise, but uses ASCII Control 
Characters for Commands and Options . 

PKASO Command = <ASCII CTRL Char> <Options> 

Options in this case are supplied in only one 
way: as ASCII character values, codes 0 thru 255, 
which may or may not be printable. 

For eaample, the command becomes 

^trcO#, an option of 5 becomes CHR$<5>, etc. 

This mode of supplying commands to PKASO is 
always active IN ADDITION TO the format , 
and provides a second method for supplying 
commands which may be preferable for some 
applications . 

It is ONLY suited for software which adheres 
strictly to Apple ///*s convention of allowing 
all Control Characters to be printed. In Pascal, 
for eaample you can use UNITVRITE to send most 
commands in Ctrl Char Form , however a $00 can not 
be sent . 

To select this format exclusively, set DCB byte 9 
to a 00, or use the PKASO Lead-in Command above 
with a NewCode of 0 . 

IMITIALIZATIOM OF THE SETTINGS 

The first time the PKASO system is opened after a 
boot, or whenever a PKASO SOFT RESET command is 
done, the printer is set up as described by the 
Driver Configuration Block . These are the 
"Default** settings. After this, the PKASO system 
does no more resetting or initializing , so 
printer settings will generally stay the same 
unless you change them . 
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SIZE COMMAND 

The SIZE command can request any of the printing 
widths provided by your printer. 



SIZE 


Command : 


Selects character width 


Cmd 


F 0 r ma t : 


"E <SizeCode>, 


Ctrl 


Char Form: 


E 


F r om 


Basic: 


PRINT '"“E" ;SIZE ; 


F r om 


Pascal : 


WRITE (PR, • '"E ‘ ,SIZE , • , * ) 



Selecting a character size is relatively simple . 

The command may be included anywhere in your 
teat , and the character size will indeed change 
in the middle of the line where the command is . 

The sizes are selected by a size code . This 
table shows the codes and the widths expressed in 
characters per inch . 



Size 


Code 


Command 


Size 


Code 


Command 


5 CPI 


8 


“E8 , 


10 


0 


^EO, 


6 


9 




12 


1 


"'El , 


8 . 25 


10 


'^ElO, 


16 . 5 


2 


"'EZ, 



You also may control any proportional spacing and 
emphasize modes using ESC and BYTE commands. 

For example, to select 16.5 CPI (compressed) 
printing , use E2 . 

NOTE: Use the SIZE Command, not the printer's 
direct compress or expand ASCII codes, or you may 
find that the PKASO driver overrides your 
settings . 
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SIZE COMMAND <Conf d . > 

The following shows a sample of the range of 
print sizes from S cpi to 16.5 cpi. 

FIXED SPACING 



nriiL & Q xj ± ic 
TMe Qxiiolc Brown 
The Quick Brown Fox 
The Quick Brown Fok Jumped 
The Quick Brown Foe Jumped Over 
The Quick Brown Foi Joiped 0?er The Laxf Dog 



5.0 C E I 
. O CPI 
8.25 CPI 
10 CPI 
12 CPI 
U.5 CPI 



PROPORTIONAL SPACING 



T7 Tx ^ Q xj± cnIc 
TIiL€f Quick: Brown 

The Quick Brown Foz 
The Quick Brown Fox Jumped 
The Quick Brown Fox Jumped Over 
The Quick Brown Fox Juxped 0?er The Laxy Dog. 



5 . O QEI 

6 . O CPI 
8.25 CPI 

10 CPI 
12 CPI 
U.S CPI 



Consult your Command Chart for the sizes available 
on your printer . 
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WIDTTH COMMAND 

Tlie WIDTH command sets the maximum number of 
characters on a line. If the margins are all set 
to zero and you start printing characters at the 
left edge of the paper, this is how many you can 
print before the PKASO system inserts a Carriage 
Return and a Linefeed and takes you to the next 
line . 



WIDTH 


Cmd : 


Sets line 


width in char s . 


Cmd Fo rma t : 


"'D <Width 


i n Cha racters) , 


Ctrl 


Char Form: 


D 




F r om 


Basic : 


PRINT 


; WIDTH; “ , “ 


F r om 


Pasca 1 : 


VRITE(PR, • 


'"D’ , WIDTH, ' , • ) ; 



NOTE: Most Apple /// interpreters such as Basic 
and Applewriter /// handle the end of each line 
themselves, in which case the PKASO width can be 
left at 255, which switches off PKASO line width 
checking . 

Some languages may need line width to be enforced 
by the PKASO system, so the Width parameter 
should be set to match the printer size, the 
paper width, and the character size in use. For 
example, for standard 8.5'* paper and 10 
characters per inch, use a width of 80 
characters: PRINT "'*D80,“; 

MAFLGirsI COMMAND 

Left and right margins are supported by PKASO . 
They are measured in characters, inward from the 
edges of the page, as set by the Width command. 
Note that this means the WIDTH and MARGIN 
commands interact, and the effective number of 
characters you can print on a line is Width minus 
Left Margin minus Right Margin . 
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A third type of margin is also provided. This is 
called the Wrap Margin. If printing exceeds the 
right margin, it “wraps" around the page to the 
next line and starts not at the left margin, but 
at the Wrap Margin. This is useful for setting 
up paragraph indentation . 



1 MARGIN Cmd . : 


Sets all margins. I 


Cmd 


F o rma t : 


"'C<LM> 


, <RM> , <WM> , 


Ctrl 


Cha r Form: 


C 




F r om 


Basic : 


PRINT 


n~c" ; 






LM; , 


•* ; RM; “ ; ;WM; " 


F r om 


Pascal : 


WRITE 


(PR, • "'C • , 






LM, • , 


• , RM , • , • , VM , • , ‘ ; 



The Margin command takes effect as it is 
encountered in printing. This means it affects 
the right but not the left margin of the present 
line. Follow the command with a Carriage Return 
to start a new line at the new left margin . 

<Omit the final in Basic, or use WRITELN in 

Pascal . ) 

Since margins are calculated with respect to the 
present page width, you should avoid setting 
things up so that there is no room on the page. 
(Width minus margins is too small . > 

For example, lets say you want to set up a 
centered paragraph format with 60— column lines 
and the first line indented 5 spaces . Using the 
standard 80-column Width, this would be done as 
follows: 

PRINT , ";10;" , ";10;" , " 
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TAB COMMANDS 

The PKASO system includes its own flexible tab 
feature. The operation is similar to tabs on a 
standard typewriter: you can SET tabs at up to 16 
different columns and you can CLEAR all tabs . 

The HT command is used during printing to space 
over to the desired column. 



TABSET Cmd . : 


Adds N stops to tab list. 


Cmd 


Fo rma t : 


'*'F<N> , <T1 > , . . . <TN> , 


Ctrl 


Char Form: 


F 


F r om 


Basic: 


PRINT **~F*‘ ; n ; “ , 

T1 ; " , ;T2 ; . . . ;TN** , '* ; 


F r om 


Pascal : 


WRITECPR, * "'F • ,N, ‘ , 

T1 , • , 'T2 , . . . ,TN, • , • ) ; 



TABCLR Cmd . : 


Clears all tab settings. 


Cmd F o rma t : 


"'FO , 


Ctrl Cha r Form: 


F 


F r om Basic : 


PRINT 


F r om Pascal : 


WRITE < PR, • '"FO , ' ) ; 



HT C 


ommand 




Spaces to next tab stop. 


Cmd 


Fo rma t 




'"I 


Ctrl 


Cha r 


Fo rm : 


Ctrl- I 


F r om 


Ba s i 


c : 


PRINT "'"I,"; 


F r om 


Pasc 


al : 


WRITE < PR, * '"I , * ) ; 



The system also has an auto— tab mode: if you tise 

the HT command without setting any tab stops, or 
if you are beyond the last stop on your tab list, 
this takes you TO THE NEXT EVEN MULTIPLE OF 8 
COLUMNS. 

Tabs are used in the order in which you set them . 

If the next tab stop is to the left of the 
present print position, THE SYSTEM DOES A 
CARRIAGE RETURN AND A LINEFEED, then goes to the 
requested column . Thus one set of tab stops can 
completely format a multi-line mailing label or 
payroll check printout . 
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TAB COMMAND (Confd) 

For example, to set up a mailing label printing 
format , 

Name 

Address 

City State Zip 

you could use the following TABSET command: 

1, 1,20,27, 

Then an entire label can be printed as a simple 
string with interspersed HT commands . 

100 HT$ = ••'T' 

110 PRINT# 1; NAME$ + HT$ + ADDR$ + HT$ + 

CITY$ + HT$ + STATE$ + HT$ + ZIPS 



VEFtTICAL SBACIIMG COMMAND 



This command adjusts the function of Line-feed 
for graphics or text spacing . 



VS Command ; 


Sets Vertical 


Spacing 


Cmd F o rma t : 


"'T<V> , 




Ctrl Char Fo rm : 






F r om Basic: 


PRINT •'"'T*' ; V; ” 


M . 
« 1 


F r om Pascal : 


WRITE < PR, * -'T' 


1 ‘ V • ' i • 



The number V selects the spacing as follows: 

0 - Standard text spacing <6 LPI) 

1 - HiRes print spacing for your printer. 

<See the Command Chart . > 

2 - Gray Scale or graphics 6 dot spacing . 

3 - Bit graphics 7— dot spacing. 
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e-eed command 

This is the customary ASCII new page command. It 
puts you at the top line of the new page, at the 
left margin. Your printers form length setting 
(usually 11" or 66 lines) determines the position 
of the top of the new page. 



FF Command : 


Skips to the next page 




Cmd F o rma t : 


'“L 




Ctrl Char Fo rm : 


L 




F r om Basic : 


PRINT ••"'L*'; 




F r om Pascal : 


WRITE (PR, ' "'L • ) ; 




EIIME — EEED 


COMMAND 


LF Command : 


Scrolls paper up 1 line. 


Cmd F o rma t : 




Ctrl Char Form; 




Use f r om Basic 


or Pascal is Automatic. 



Line Feed moves to the left margin of the next 
line. 

The PKASO system has three vertical spacing 
modes: text, dot graphics, and gray scale. 
Line-feed spaces the paper up by the proper 
number of dot spaces for the present spacing 
mode . 

The convention in Apple /// software is that the 
software, not the printer, furnishes the 
necessary line-feed at the end of each line of 
text . The PKASO system merely passes these 
line-feeds through to the printer. 

If you want to use your printer's auto line— feed 
after carriage return feature instead, then you 
can, using SCP , set Driver Configuration Block 
byte 7 to a 0. PKASO will then block line-feed 
characters from reaching the printer and causing 
double spacing . 
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SOE-T — F-OlsiT COMMAND 

Your printer has a built-in character set or Font 
which it uses for standard teat printing . 

Whenever a printer receives a printable character 
from the computer « its character set table is 
automatically consulted to get the dot— pattern 
which forms the symbol on the paper. This is 
convenient and fast, since it all happens in the 
hardware and firmware of the printer. 

If you want a different style of characters or a 
symbol which is not included on your printer, 
however, you have a problem. PKASO gives you the 
solution by providing a choice of the standard 
printer characters OR Sof tFont , the Apple III 
screen characters! The SoftFont system uses the 
printer's dot graphics capability, and Apple 
///'s present character table to produce 
characters . 



FONT 


Command ; 


Selects Print Style 


Cmd 


F o rma t : 


"'R<F> , 


Ctrl 


Char Form: 


R 


F r om 


Basic : 


PRINT “"'R“ ; F ; ; 


F r om 


Pascal : 


WRITE ( PR, • "'R" , F , ' , ‘ ; 



F is the Font Code, used as follows: 



Standard Printer Font 


Code 


0 


Apple II i Screen Font 


Code 


1 


Compressed Screen Font 


Code 


3 


Inverse Screen Font 


Code 


5 


Inverse & Compressed 


Code 


7 



NOTE: The FONT Command and its options depend on 

the printer . <See you Command Chart) . The 
selection of character SIZE does not have the 
normal effect on SoftFont printing. SoftFont 
characters are a f ised width and height . 
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TEXT ER.I1MT 
SCREEN 0\JMP COMMAND 

This command prints a snapshot copy of the teat 
screen at the present left margin . 



TPRINT Cmd . : 


Prints the 


Tent Screen 


F o r ma t : 


"'P<Mode> , 




Ctrl Char Fo rm : 


P 




F r om Basic: 


PRINT “"'P*' 


;M0DE 


F r om Pascal : 


WRITE (PR, 


■ ~P • ,mode 



Four modes are provided to match Apple III screen 
test formats: 

0- 40 column standard screen 1 

1- 40 column screen 2 (*> 

2- 80 column standard screen 

3- 80 column reversed interlace <*> 

(* - for custom software) 

If it is possible on your printer, the PKASO 
system prints the teat screen using the Apple III 
screen character set and line spacing. After the 
print , line spacing returns to 6 LPI . 

See your Command Chart for the standard TPRINT 
mode, teat font or screen font, for your printer. 
If screen font is standard, then: 

1 . To print in inverse mode (white on black) add 
4 to the mode number . 

2 . To select teat font instead (using the 
character set selected by the FONT command, and 
the present printer vertical line spacing, 
usually 6 lines per inch) add 8 to the mode 
number . 







HIRES ERIIMTT 
SCREHN DUMP 
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HiRes screen printing is done by an Invokable 
Module named PKASODMF . INV . The module has 
entries BPKASODMP for Basic, and PPKASODMP for 
Pascal. Copy PKASODMP.INV onto your working 
software diskette for easiest use. From Basic: 

INVOKE PKASODMP.INV 

PERFORM BPKASODMP<@PRNAME$, %MODE> 

From Pascal: The module must be linked 

directly from PKASODMP.INV. Define it 
and use it as follows: 

PROCEDURE PPKASODMPCVAR PRNAMEiSTRING; 
MODE:INTEGER); EXTERNAL; 

PPKASODMP <PRNAME , MODE) ; 

PRNAME is a string containing the name of the 
printer device <e.g. .PRINTER.) 

COLORS PRINTED IN GRAY. . . 

Screen colors are printed using gray levels 
composed of dot patterns . The number of 
distinguishable levels (patterns) depends on the 
plotting size selected, and on your printer's 
graphic dot format . To esperiment with the sizes 
and styles on your printer, RUN PRINTPIX on the 
PKASO /// disk. 

The smaller formats of HiRes print do not have 
sufficient resolution to directly print all the 
information on the HiRes screen . These are 
printed with a reduced number of gray levels, 
combining groups of color codes . A statistical 
option is provided which may give a more complete 
gray scale using featuring . Experiment with 
these formats to find the best one for your 
graphic application . 
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There are a large number of options to choose 
from in requesting a HiRes screen print . Here is 
how to construct the Mode number which describes 
to the PKASO system the type of print you want. 

HOW IT WAS PLOTTED . . . 

First of all, a HiRes picture on Apple III is 
created in one of 4 formats. It must be printed 
in the same format . Choose this format number 
first in constructing Mode: 



Format 


Descr i p t i on 










0 


Black & White, 


280 


I 


192 


points 


1 


16 L imi ted Colors, 


280 X 


192 points 


2 


Black & White, 


560 


X 


192 


points 


3 


16 Colors, 140 


K 192 


points 



HOW YOU WANT TO PRINT IT . . . 

Secondly, there are other choices you may make 
which determine how the print will appear on the 
page. The default or normal print is a Small, 

Right -Side~Up print of HiRes page 1 . Each of the 
options is assigned a numeric factor . To select 
one or more options, ADD ITS FACTOR to the Format 
number chosen above: 

Add 4 for a rotated picture 
Add 8 for a medium size picture 
Add 16 for a large size picture 
Add 32 to select HiRes screen 2 . 

Add 64 to invert blacks, whites & grays. 

Add 128 for statistical gray levels . 



The result of this is a number which is used for 
the Mode in the HiRes command. 
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For esample, to print a 560-point graphics screen 
in small rotated format , 

1 . Choose format 2 for 560 mode . 

2 . Add 4 for a rotated print . 

3 . The sum is 6 - - use this for MODE 

HORIZONTAL POSITIONING. . . 

The HiRes print always starts at the present Left 
Margin . To change the position of a print to 
anywhere on the page, simply set the margin 
accordingly . 

VERTICAL SPACING 

If you want space vertically between HiRes 
prints , then print blank lines . Since no space 
is automatically inserted, prints may be produced 
contiguously on the page . This can be used to 
print a continuous **strip chart" format . 

CANCELLING THE PRINT. . . 

To cancel, press ALPHA LOCK once. The system will 
beep and stop printing. Then push ALPHA LOCK 
again to toggle it back the way it was . 
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ORA.Y COMMAND 

The PKASO system has a built-in capability to 
print in gray levels. This can be used in 
conjunction with selection of ribbon color to 
control color saturation for an unlimited miaing 
capability. The GRAY command puts the system 
into Half Tone mode, then each character you send 
to it will be printed as a Piael, in one of 16 
levels of gray using a random dot pattern. 



GRAY 


Command : 


Prints 


i n 


gray levels 


F o r ma t ; 


"'U<N> , 


<G1 > 


, . . . , <GN> , 


Ctrl 


Cha r Form: 








F r om 


Basic : 


PRINT 


II ]|j •» 


; N ; " , ; 






G 1 ; , 


II . 

t • • 


. ; GN; ; 


F r om 


Pascal : 


WRITE 


(PR, 


■ “U' ,N, • , • , 






G1 , • , 


1 

/ • • 


. , GN, • , • ) ; 



The GRAY command sets the line spacing to 6 dots 
per line and prepares the system to print the 
neat N characters <G1 . . . GN> as gray scale <or 
color) piaels. N may be any number from 1 
through 192. After N characters, the system 
returns to teat mode, but stays in dot spacing, 
ready for more GRAY commands . 

Each character code produces a gray piael, 5 dots 
wide by 6 dots high . Values may be between 0 
(white) and IS (black) . A good set of character 
codes for the set of 16 gray levels is: 

WHITE Lt.Gray Med. Gray Dk.Gray BLACK 

0 123456789JKLMN 0 

For eaample, to print a gray scale in Basic: 

PRINT ••'"U16,0,l,2,3,4,5,6,7,8,9,J,K,L,M,N,O," 
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For example, to print a gray scale in BASIC: 

PRINT CHR$(21>;CHR$<16>;“01234S6789JKLMN/** 

Epson MX-80 and MX— 100 print pixel pairs. Each 
character code produces two pixels, one above the 
other. For Epson, the character code is 
constructed as follows: 

G 5SS Glo * 18 + Ghi 

To print a gray scale on an Epson printer: 

PRINT CHR$(21>;CHR$a6>;: 

FOR I = 0 TO 15 : PRINT CHR$a*18+I> : NEXT 
TEXT COMMAND 



To clear all graphic modes and return to text 
spacing, use the following: 



TEXT 


Command : 


Re turns to tert 


mode, spacing 


F o r ma t : 


-'UO , 




Ctrl 


Char Form: 


U & 




F r om 


Basic : 


PRINT "'"UO , •• ; 




F r om 


Pascal : 


WRITE (PR, ‘ -'UO , 


• ) ; 
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SUFEFL — RES GRAPHICS 

The Super Res DOT command lets you send bit 
graphics information directly to the printer . It 
prints any teat still in the buffer, sets the 
printer into graphics mode and prepares to print 
character codes as dot graphics patterns . 

Each character is printed as a vertical dot 
pattern that is one dot wide. Each dot in the 
pattern is controlled by one bit in the character 
code . Bit 0 always controls the bottom dot , bit 
1 controls the one above it, etc, to conform to 
normal graphing conventions. The PKASO system 
takes care of shifting and reversing of bits 
necessary to produce this format , and also the 
quirks in handling ETX codes, so this paragraph 
may supercede the eaplanation and esamples in 
your printer manual under the graphics option . 
See the Command Chart for dot formats for your 
printer . 

In designing printer-independent software, you 
must be aware of the fact that printers from 
different manufacturers may have 6 , 7, or 8— dot 
patterns for each SuperRes character . If you 
write software which produces 6— bit graphics, it 
will work identically on all printer types . You 
can also use Status Requests (Appendix B> to 
determine and adjust to the printer's dot format. 

This command does not change vertical spacing . 
Use VS commands to switch in and out of dot 
graphics spacing if desired . 
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DOT COMMAND 



DOT Command : 


Enter SuperRes Graphics Mode 


F o rma t : 


"'Z<Nlo> , <Nhi > , 


Ctrl Char F o rm ; 


CTRir Z 


F rom Basic : 


PRINT ”"'Z" ;NL0; ; 




NHI ;**,•*; 


F r om Pascal : 


WRITE <PR, * '"Z * , 




NLO, ‘ , * ,NHI , ' , M ; 



N is the length specification, and may be any 
number between 1 and 65535. Nlo and Nhi are the 
two halves of N . These are created as follows: 

NHI = N/2S6: NLO = N - 256*INT<NHI) 

After N characters, the system switches out of 
graphics mode . Your printer may also switch out 
of graphics mode under certain conditions, such 
as eaceeding the right margin. See your Command 
Chart. 

For example, to print a pyramid in Basic, use the 
following command: 

PRINT ••-"Zll,0,";chr$a>;CHR$<2);CHR$<4>; 
CHR$<8>;CHR$a6>;CHR$<32>;CHR$<16>; 
CHR$(8>;CHR$<4>;CHR$(2>;CHR$a> 



This prints: 
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BYTE COMMANDS 

These commands create a momentarily "dumb" 
printing system by allowing you to send 
characters directly to the printer, as— is, in 
their binary form . No margin control is 
performed, font selection is bypassed, and the 
PKASO Driver does not even watch for commands. 
All characters printed are sent unmodified to the 
printer . 

N BYTES . . . 

This command instructs the system to allow the 
next N characters to pass to the printer as— is . 



NBYTE 


Command : 


Prints N bytes as-is 


F o rma t : 


'"Y<Nlo> , <Nhi > 


Ctrl 


Char Form; 


Y 


F r om 


Basic : 


PRINT •'"'Y” ;NLO; “ , ; 






NHI ; “ , " ; 


F r om 


Pascal : 


WRITE (PR, • ~Y ‘ , 






NLO, ’ , • ,NHI 



N is the length specification, and may be any 
number between 1 and 65535 . Nlo and Nhi are the 
two halves of N. These are created as follows: 



NHI 



N/256: NLO 



N - 256*INTCNHI) 
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THE BUFFER AS BYTES . . . 

When you print a string or string eapression in 
BASIC , all the characters go into a ''Buffer'* area 
in Apple /// memory « and then on to the printer. 
The BBYTE command can be inserted in the string 
or string eapression, and all characters AFTER 
the command will be printed directly without 
modification or command processing. 



BBYTE Cmd . : 


Rest of buffer as-is 


F o r ma t : 


"'B 


Ctrl Char Form: 


B 


F r om Basic: 


PRINT "~B"+"Data" 


From Pascal: 


No t useful 



This command is useful in printing command 
parameters and graphics dot sequences. For 
eaample, to send an ESC command followed by 
control characters to the printer, set the 
command up as a string with CHR$(27> as the first 
character and CHR$(2> as the second. Then add 
the control codes, and they will be sent to the 
printer unmodified. 

Remember that PRINT A$^B$ prints a single string 
expression <buffer> but PRINTkA$;B$ actually 
prints two buffers . (Pascal breaks all printing 
into 1-character "buffers" so this command is not 
applicable . > 
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STRIMG OF BYTES . . . 

This lets you set up bytes using the Options 
format, then sends the bytes directly to the 
printer without processing . NOTE that this is a 
variable length format , in which you use the 
Options format for as many bytes as you want to 
send, with a "3“ after the last byte to be 
transmitted . 



BYTE 


Comma nd : 


Sends 


characters AS-IS 


F o rma t : 


~S<Opt ions) ] 


Ctrl 


Char Fo rm : 


S 


(See be 1 ow ) 


F r om 


Basic : 


PRINT 


" ~S" ; <0p t i ons 

. 


F r om 


Pascal : 


WRITE 


(PR, ‘ ~S' , (Options 



K single command can be used to send from 
1 to 254 bytes to the printer . 



NOTE: For the Ctrl Char Form of this command 
only one character can be transmitted. For 
example A . 
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ESCAPE COMMAND 

The printable version o£ the escape command now 
includes the ability to send a variable— length 
string of <Options> . The ESC <**Escape**> command 
is included to directly operate the modes and 
settings built into the printer, such as page 
positioning and enhanced printing. 

While most printer control, such as character 
size, etc., is handled by standard PKASO 
commands, you may have an application which uses 
the printer in an unusual way. These are 
generally accomplished using "Escape Sequences.*'. 



ESC Command : 


Sends ESC for 


printer control 


F o rma t : 


L <Printer 


Op t i ons > 3 


Ctrl CTiar Form; 


C 




F r om Basic : 


PRINT "“t"; 


< Op t i ons 


F r om Pascal : 


WRITE (PR, ■ 


t * , < Op t i ons 



You can send Option characters which may not be 
printable characters as Decimal, Hea, or Literal 
codes inside the brackets. For eaample, ^ L71 
sends the sequence ESC 

If the Options are printable, they can be sent 
after the 1 . For eaample , the Basic statement 
PRINT ••-'C3G, 120,$** sends an ASCII sequence 
ESC G,120,$ which positions an IDS Prism 1" from 
the left edge of the page . 






Page 35 



The <Options> of the command function like 
the <Options> of the Command: A command 
Cl, 2, 33 is equivalent to 
-*C3-^S1,2,33. 

The Ctrl Char Form, has no option 

processing and merely sends an ESC, as in 
Revision 2 . 



IT'S NOT NICE TO FOOL MOTHER PKASO . . . 

NOTE: Do not use ESC sequences where you could 
use PKASO commands instead. For eaample, if you 
use the direct ESC command to change a printer's 
character size, the PKASO driver will change it 
back again . 

In your Command Chart is a summary of the ESC 
commands you will find most useful. More details 
about their operation can be found in your 
printer manual . 
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E=>R.irNlTER T7YE»E COMMANDS 

If you write software to run on more than one 
variety of printer, these commands let your 
software ask the user for his printer type, then 
re— configure the driver "on-the-fly” to match. 



PTYPE Command ; 


Changes Printer Type 


F o rma t : 


'"Q<P> 


Ctrl Char F o rm : 




F r om Basic: 


PRINT "'"Q" ; P ; ; 


From Pascal. 


WRITE (PR, • "'Q' ,P, * , • ) ; 



P is the printer type code, as described in the 
DCB section . 

NOTE: This command sets the character sise to 
0.1'* You should make sure other settings are 
consistent with the printer chosen. 



To change the SubType byte, which holds 
information on printer sise and color capability, 
use the STYPE Command: 



STYPE Command ; 


Changes Printer SubType 


F o rma t ; 


-'X <S> 


Ctrl Char Form: 


\ 


F r om Basic : 


PRINT \ ; S ; ; 


From Pascal: 


WRITE ( PR, • "'X • , s , • , • ) ; 



S is used as follows: 

0-80 col. B&W 2-80 col. Color 
1 - 132 col. B&V 3 - 132 col. Color 
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SOFTWARE RESET COMMAND 

At any point you have the option to reset all 
parameters back to the settings given in the DCB. 



RESET Command : 


So f twa re reset 


F o r ma t : 




Ctrl Cha r Form: 




F r om Basic : 


PRINT “'"V; 


F r om Pascal : 


WRITE ( PR, ' '"W ) ; 



Unlike the OPEN operation which initializes 
printer settings only the first time it is done, 
SOFTWARE RESET always puts the driver and 
interface in the starting state described by the 
DCB. 

MEMORY USAGE 

The complete PKASO Driver occupies approzimately 
5000 bytes of memory. The invokable module for 
HiRes screen prints requires approximately 4000 
bytes . 

ASSEMBLY LAIMGUAGE 
PROGRAMMING INTERFACE 

The following briefly describes the PKASO direct 
I/O interface for diagnostic and development 
purposes. Direct programming of I/O devices 
requires an extensive understanding of the SOS 
environment, I/O drivers, and Apple III hardware. 
All accesses to the PKASO interface must be done 
in 1 MHz mode . All guidelines regarding use of 
the I/O provisions of Apple /// must be observed. 
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STATUS INPUT FROM THE PRINTER . 

The printer status register is located at hexadecimal address 

$C080 -I- NO <N is the PKASO slot number) 

A hyte read from this address is arranged as follows: 

Bi t : 7 6 5 4 

"1” = Int . Ready Paper Out On Line 

"0" = No Int . Busy Paper OK Local 

Bits 3, 2, 1,0 are not used. 

Bit 7 is used to denote an active interrupt coming from the PKASO, 
and may be used by an interrupt service routine to identify a 
PKASO interrupt. Bits i and 4 indicate the status of the printer. 

If bits 7 thru 4 are "0101", the printer is ready to accept data. 

OATA OUTPUT TO THE PRINTER. . . 

The locations associated with output of a data byte are the 
following: 

$C800 Strobe Down, Interrupts off, Cleax IRQ 
$C801 Strobe Up, Interrupts off. Clear IRQ 
$C802 Strobe Down, Enable IRQ on Ack . 

$C803 Strobe Up, Enable IRQ on Ack. 

A byte is sent by writing it to these addresses so as to toggle 
the strobe in "up-down-up" sequence. 
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HEirsITS 

USE WITH POPULAR LANGUAGES AND SOFTWARE 

APPLE II EMULATION MODE ~ Normal operation as 
Apple II printer system. See your Apple II PKASO 
manual . 

APPLEWRITER /// - Full use of PKASO Commands from 
within the teat . Use the ^ commands to set 
character size, etc. 

APPLE Business Graphics - The PKASO system can 
provide full printing capability for this 
package . See the next page . 

APPLE Business Basic - Follow the instructions 
and examples in this manual . RUN PRINTPIX to 
dump HiRes images . 

APPLE PASCAL - Follow the instructions and 
examples in this manual. XCecute PRINTPIX to 
dump HiRes images 

VISICALC /// ~ Send PKASO commands in the 
printing setup string, or include them within 
labels on your sheet. Example: Use *"*E2,“ to 
select compressed printing . 

WORD PROCESSORS IN GENERAL - Consult the manual 
for the proper procedure for installing a driver, 
then include commands directly in the text . 

If the package is inextricably attached to its 
own direct printer control software, install 
MINI DRIVER. 
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APPLE BUSIlsIESS GFL APHICS 
GRAPHIC PRINT PROCEDURE 

With Apple ///, any program which needs to use 
the printer must have the PKASO Driver installed 
or its program diskette. So you must go through 
the procedure which we describe in great detail 
in Appendix D to put the PKASO Driver on your 
Business Graphics Diskette. Then you are ready 
to print any picture you create with Business 
Graphics . 



1 . 


Boot your Business Graphics diskette 
(with PKASO Driver installed) . 


2. 


Create the plot on the screen. 




3. 


Save it on disk. 




4. 


Quit. 




5. 


Insert the PKASO /// diskette in 
built-in drive. 


the 


6 . 


Type Pascal will ask "What 


File?". 


7. 


Type "/PKASODRIVER/PRINTPIX". 




8. 


Follow the program's instructions 
and print images. 


to load 


9. 

the 


When PRINTPIX asks you for 
name of your picture file. 





enter the COMPLETE form of 
the filename, including the device name 
(.01/ etc.), and the filename with the 
suffiK .S.DATA added. 

EXAMPLE; . D2/graphl . S . DATA 

10. If you created the image with Business 

Graphics mode 2, print it with PRINTPIX mode 3; 
BG mode 1 becomes PRINTPIX mode 2; 
and mode 0 stays the same . 
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AFFEIIMDIX A 

PKASO /// QUICK COMMAND REFERENCE 
PKASO 



NAME 


CMD. 


ARGS 


FUNCTION 








None . 
None . 


BBYTE 


-'B 




Buffer BYTE mode . 


MARGIN 


“C 


<LM,RM,VM> 


Set margins . 


WIDTH 


“D 


<Vidth> 


Set line width 


SIZE 




<Si ze Code) 


Set char size. 


TABSET 


• F 


<N,T1 . .Tn> 


Set tab s t ops 


BELL 


"'G 




Ring printer bell 


BS 






Backspace 


HT 


*'1 




Go to next tab stop 


LF 






Line feed 
None . 


FF 






Form feed 


CR 


"'M 




Carriage return 


COLOR 


'•N 


<ClrCode> 


Select Ribbon 


LEAD-IN 


~0 


<NewCode > 


Change 


TPRINT 


-.p 


<Mode > 


Text screen dump . 


PTYPE 


-Q 


< Pr t ype > 


Printer type 


FONT 


-'R 


<Chmode > 


Character set mode 


BYTE 


~S 


<Opt ions) 3 


String of BYTEs 


VS 




<VSmode) 


Vertical Spacing 


GRAY 


"'U 


<N,G1 . .Gn) 


Gray Scale mode 


BDOT 


-V 


(Buffer) 


Single Buffer Graphics 


RESET 






Software Reset 
None . 


NBYTE 


"'Y 


<Nio ,Nhi . . ) 


N Char. BYTE mode. 


NDOT 


*Z 


<Nlo,Nhi . . > 


N Char. Bit Graphios. 


ESC 


-'C 


<Opt ions) 3 


Send ESC Sequences 


STYPE 




(SubType > 


Width, Color, etc. 
None . 

None . 

None . 



HiRes Print: INVOKE PKASODMP.INV 
PERFORM <ePR$,%MODE) 
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AFPEIlsID IX B 

STATUS & CONTROL REQUESTS 
A . STATUS REQUESTS 

The PKASO Driver provides status requests which 
allow the user to determine the characteristics 
and condition of the printer driver and printer. 

The Status Request is a standard SOS operation, 
however different interpreters provide different 
means of performing status requests. Business 
basic uses the invokable REQUEST . INV to get the 
status information . Pascal programs use the 
intrinsic procedure UNITSTATUS . 

FROM BUSINESS BASIC . . . 

INVOKE "REQUEST. INV 
OPEN #1," .PRINTER" 

PERFORM STATUS <%STATCODE , ©STATLST$>" .PRINTER" 

STATCODE contains your status request code. 

STATLST$ gets loaded with status information . 

To get the N*th status byte: 

STAT = ASC (MID$ (STATISTS , N , 1 > ) 

FROM PASCAL. . . 

UNITSTATUS (UNITNUM, STATIST, REQCODE); 

For the printer, UNITNUM should be 6 . STATIST is 
a variable whose structure is dependant on the 
status requested. (See below.) REQCOOE is a 16 
bit value which determines the type of status 
call requested. For instructions see Appendix H 
of the Standard Device Drivers manual. 




Page 43 



STATUS REQUEST MUMBERS . 

3 - Get printer status . 

This call returns 5 bytes: 

0 - Printer type (See the DCB) 

1 - Printer mode byte 1 

2 - Printer mode byte 2 

3 - Printer vertical spacing: 

0 = Standard teat (6 LPI) 

6 = Graphics spacing (6 dots) 

7 = Graphics spacing (7 dots) 

8 = Graphics spacing (8 dots) 

4 ~ Printer on-line & paper status: 

0 = Ready to print 

1 = Off line 

2 = Paper out 

3 = Off line and paper out 

4 - Margins and sizes 

This call returns 5 bytes: 

0 - Width of page in characters 

1 - Left margin 

2 - Right margin 

3 - Wrap margin 

4 - Character size code. 

5 - Tab information 

This call returns 18 bytes: 

0 - The number of tab stops now set 
1. . .16 - The tab stops 

17 - The neKt tab stop to be used 

*dS - The Command Lead-in Byte 

Returns present lead-in , etc.) 

7 - The Printer Sub-type Byte 

0-80 col/ B&V 2-80 col, Color 

1 - 132 col, B&V 3 - 132 col, Color 
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B . CONTROL REQUESTS 

The PKASO driver provides a selection of control 
request functions to set driver parameters . 

FROM BUSINESS BASIC . . . 

Perform the Control Procedure in the REQUEST . INV 
invokable: 

CONTROL <%CTRLCODE, ®CTRLLIST$) PRINTER” 

%CTRLCODE contains the number of the control 
fimction requested. CTRLLIST$ contains the 
control information to be set . 

FROM PASCAL. . . 

Use the UNITSTATUS function as described under 
Status Calls « above, setting the STAT— OR— CTRL 
field to 1 instead of 0 . See Appendix H of the 
Standard device drivers manual . 
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COMTROL. REQUEST MUMBERS . . . 
REVISION 3 

3 Flush Buffer. 

(no control list) Causes any printing in progress to finish. 

(For eKample, to prepare for a switch to some graphics mode.) 

This dumps the Apple screen font buffer if active. Should be 
called before doing your own graphics. 

<1 Restore Size 

(no control list) Sets the printer character size to 
that given by the last SIZE command. 

5 Set vertical line— feed spacing . 

The control list is a 1-byte size code: 

0 - Teat spacing, 6 LPI 

1 - HiRes print spacing for your printer. (6 or 8 dots) 

2 - Gray Scale spacing, 6 dots. 

3 - 7 dot spacing 

6 , Turn off dot graphics mode . 

(no control list) Also restores char size. 

7 Turn on dot graphics mode . 

(no control list) 

8 Send graphics length in chars. 

The control list is the 16-bit length, low byte first. 

7 Set margins and sizes . 

The control list is 5 bytes long; 

0 - Line Width 2 - Right Margin 4 - Character Size Code 

1 - Left Margin 3 - Wrap Margin 
1 O Set tabs . 

The control list is 18 bytes long: Byte 0 - Number of tabs set. 
Bytes 1 ... 16 - Up to 16 tab stops, Byte 17 - Neat stop to be 
used 

1 1 Set Lead-in Character . 

The control list is 1 byte - the new lead-in character. 

Set Printer Sub-Type Byte . 

The Control list is 1 byte - 0 = 80 col B&V 2 = 80 col Color 

1 = 132 col B&V 3 = 132 col Color 



17 
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APPEIMDIX C 
THE MINI DRIVER 

In addition to the PKASO. DRIVER described in this 
manual, the PKASO III diskette also contains a 
mini-driver which occupies only 512 bytes of 
storage. It can be installed using the same 
procedures given in Appendix D, with the file 
name MINI . DRIVER . The printer Slot Number is the 
only settable option for this driver. 

It has one and only one function — to transfer 
bytes absolutely unaltered to the printer. There 
are no commands, no options, no print sizes, no 
margins. Everything printed will be transmitted 
to the printer without processing. 

MINI. DRIVER does not support the PKASODMP.INV 
or PKASOCLR.INV graphics invokables . 

MINI. DRIVER is intended for the system 
application where programming has already been 
done to handle a printer, or where special 
requirements exist. For example, the full PKASO 
driver will not fit on a standard System 
Utilities diskette, so MINI. DRIVER can be used 
instead to provide printing of simple text . 
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AFFEMDIX D 
INSTALLATION of the PKASO Driver 

Each software package or language system which will directly use 
the printer must have the PKASO Driver "installed" on its 
diskette. Ve include the procedure here with appropriate 
filenames and terminology for the PKASO Driver. 

It is always best to use a COPY of your diskette for the driver 
installation. The PKASO interface card should be installed in 
SLOT 1. 

1. Boot your Apple III SOS Utilities Diskette. 

2. Select the System Configuration Program (SCP) 

3. Select the READ A DRIVER FILE option, and use SOS. DRIVER as a 
file name. 

4. Place your software diskette (the one which is to get the new 
the PKASO Driver) in the built-in drive and hit 'RETURN*. This 
loads your diskette's present drivers into Apple ///'s memory. 

Note: Press RETURN only after entering the driver filename! As 
soon as you see the list of drivers, press ESCAPE to return to the 
SCP menu. (If you pressed RETURN here, eatra copies of the driver 
file would get loaded.) 

5. You will see a list of the present drivers. If you see: 

.PRINTER .QUME ,or .SILENTYPE 

then select the DELETE A DRIVER option to remove them. 

6. Select READ A DRIVER FILE again to pull the PKASO Driver into 
memory . 
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7. Insert your PKASO III Driver diskette in the built-in drive. 

Use the filename PKASO . DRIVER . Remember, press RETURN only once 
after the file name, then press ESCAPE to go back to the main 
menu. 

8. If SCP alerts you that there is insufficient memory for the 
driver at this point, then the problem is actually that SCP hasn*t 
released the space yet which was occupied by the printer drivers 
you deleted. If this happens, go to Step 11, below. You will 
generate a system with no printer drivers, then eiit SCP. THEN GO 
BACK TO STEP 1. This time through, SCP will have plenty of space 
to work with. (If not, then MINI. DRIVER must be used.) 

9. Select EDIT DRIVER PARAMETERS, then select the CONFIGURATION 
BLOCK option. Referring to your PKASO III manual, determine the 
code for your type of printer. Select byte 0, the printer type 

byte of the Driver Configuration Block, and change it to 05, the code 
for your printer. Next select byte A, the printer Subtype, and 
change it to the proper value as specified by byte A in the DCB. 

(See Appendix E.) 

10. Returning to the SCP menu, select the CHANGE SYSTEM PARAMETERS 

option, then select PERIPHERAL SLOT ASSIGNMENTS. The new driver 
will appear as .PRINTER with a slot number of Change this to 

slot 1. Return to the SCP menu. 

11. Select the GENERATE NEW SYSTEM option. Insert your software 
diskette again in the built-in drive and write your new driver 

file onto the diskette as SOS. DRIVER. SCP may ask you to verify 
that you want to unlock and overwrite the old SOS. DRIVER file. 

Type "Y". 

12. Return to the SCP menu and QUIT. Then return to the main menu 
and QUIT. Your diskette is now ready for use. 
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APPEIMOIX E - THE OCB 
THE DRIVER CONFIGURATION BLOCK 

BYTE DESCRIPTION / INITIALIZED VALUE 

0 Printer type / set this for your printer 

00 - Epson KX-S2, Type-Hi Old HX-iOO 

01 - Epson Type III| Creftrai, Gref trai-Plus 

02 - Epson, MX-70 

03 - Centronics 737 

00 - Okidata, teit models 

05 - IDS Prism 

U - Okidata w/Okigraph 

07 - MCC PC8023, C.Itoh fSlO 

1 Status display flash rate / F8 (Heil 

2 Line width in characters / 255 (mai) 

3 Left margin in characters / 0 (none) 

4 Eight margin in characters / 0 (none) 

5 Paragraph margin in chars / 0 (none) 

i Printing Sise Code / 0 (10 CPI) 

00 . 5 CPI 00 - 10 CPI 

09 - 4 CPI 01 - 12 CPI 

OX - 0.2 CPI 02 - U.5 CPI 

03 - Proportional OB - Prop, wide 

7 Linefeed mode / 1 (software linefeed) 

00 - Printer produces all linefeeds. 

01 - Software prodnces linefeeds. 

0 Printing Character Set / 0 (standard) 

00 - Printer's standard characters 

01 - XppU screen character font 
05 - Screen font, in?erse mode 

9 Command Lead-in Byte/ 7C (') 

k Printer Sub-type / 0 (00 Col., BOV) 

00 - 00 col. BOV 02 - 00 col. Color 

01 - 132 col. B&W 03 - 132 col. Color 
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APPEMOIX F 
PRIMTERS SUPPORTED 



Parallel version of the following printers: 
(Switch the printer's auto-line feed switch OFF) 



Mf gr 


Graphics 


Text Only 


PKASO 


Name 


Models 


Models 


Card 


C. It oh 


8510 Pro/Vriter 


NE12 


Centronics 


122, 739 




CE12 


Sof t Font 


feature not 


supported . 




Epson 


MX-70, 80, 


r 100 


EP12 


For MX80, specify Type III or Graftras Plus. 


Gr a f t r ax 


-80 and Type 


II (old MX-lOO) also 




suppor ted. 






IDS 


Prism 




ID12 


Spec i f y 


Graphics and 


Color options with 




Process 


color ribbon 






NEC 


PC8023A-C 




NE12 


Okidata 


82A/83A 


80,82,83,84 


0K12 


Spec i f y 


the Okigraph 


I graphics option. 
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I-IMITEO WARRANTY 



Software and documentation connected with this product are guaranteed 
to reach the purchaser in readable condition, eacepting those failures 
which, in the sole opinion of Interactive Structures, Inc., were the 
result of misuse or abuse of the product. Defective products will be 
promptly replaced if Interactive Structures is notified within 90 days 
of purchase of this product. 

I-I ABILITIES DISCLAIMER 

NO OTHER WARRANTIES, EXPRESS OR IMPLIED, ARE EXTENDED BY 
INTERACTIVE STRUCTURES IN CONNECTION WITH THIS PRODUCT AND 
ITS DOCUMENTATION. INTERACTIVE STRUCTURES IS NOT AND WILL 
NOT BE RESPONSIBLE OR LIABLE FOR DAMAGES WITH RESPECT TO THE 
PRODUCT DESCRIBED IN THIS MANUAL, ITS PERFORMANCE, 
MERCHANTABILITY, OR FITNESS FOR ANY PARTICULAR PURPOSE. 



In using this product, the purchaser assumes the entire responsibility 
and risk as to its use and any incidental or consequential damages 
which might result. 

IMPROVEMENTS 

Interactive Structures reserves the right to make improvements in the 
product described in this manual at any time and without notice. 



© 1982 Interactive Structures Inc. 




COMLMAlslD CHART 
Centronics 122, 739 
Printer Type 3 

USEFUL ESCAPE COMMANDS 
Space left 1 dot space. 

'^161 Space left 6 dot spaces. 

Full line-feed, reverse direction 
"^C283 One-half line-feed forward. 

"^[303 One-half line-feed reverse. 



Command codes are not printable so they should be 
placed inside the brackets. 

See your Centronics manual for functional details. 




COr-lT-IAlsID CHAFLTT 
Centronics 122, 739 
Printer Type 3 

DOT GRAPHICS (LF = .0833") 

Dot format: 6 dots per character 

Dot spacing: 72 dots/** vert . 

84 dots/** horiz. 

Page format: 8** k 10** * 672 k 720 dots 

GRAY SCALE (LF = .0833**, 6 dots) 

Piael size: 5 dots wide x 6 dots high 

Coding: Each byte prints 1 pixel 

SOFT-FONT 

The 6-dot graphic format is not amenable 
to the SoftFont system. 

TEXT PRINTING <LF * .1666**, 6 LPI) 
Sizes: .1", .2** (.06, . 12 on 739) 

Size Command: Takes effect immediately. 



TEXT SCREEN PRINT 

Standard: Printer font & spacing 

Options: Set char, size to control 

screen print width. 




COr-lM AMD CHART 
EPSON MX-70 
Printer Type 2 

USEFUL ESCAPE COMMANDS 

"^□2 Set 6 lines per inch vertical spacing. 
A * Set line spacing in 1/72“ increments. 
C * Set form length in 1/6“ increments. 

K * 60 dots per inch graphics lead-in. 



Command codes are printable: e.g. “'*'C3A“ or 

* - These are followed by parameters, usually 
not printable. For these commands place the function 
codes and options inside the brackets: 
e.g. PRINT “"'C'C,123“ 

See your Epson manual for function details. 




C Or-tMAlslD CHART 
EPSON MX-70 
Printer Type 2 

DOT GRAPHICS <LF = .1065”, 8 dots) 

Dot format: 8 dots per character 

Dot spacing: 72 dots/” printhead spacing 
60 dots/” horiz. 

Page format: 8” k 10” = 480 a 720 dots 
13” K 10” = 780 K 720 dots 

GRAY SCALE <LF = .0787”, 6 dots) 

Pixel size: 5 dots wide x 6 dots high 

Coding: Each byte prints 1 pixel 

SOFT-FONT <LF = .1666”, 6 LPI) 

Options: Inverse 

Char. Width: .1333” 

TEXT PRINTING (LF = .1666”, 6 LPI) 

Sizes: .1”, .2 

Size Command: Takes effect immediately. 

TEXT SCREEN PRINT 

Standard: Screen font & spacing 

Options: Inverse, Text font & spacing 




COr-tMAMD CHART 
EPSON with GRAFTRAX 
Printer Type 1 

USEFUL ESCAPE COMMANDS 

0 Set 8 lines per inch vertical spacing. 

'*'□2 Set 6 lines per inch vertical spacing. 

3 * Set line spacing in 1/216*' increments. 

□ 4 Turn on Italics character set . 

'*'□5 Turn off Italics character set. 

'*'□9 Reset printer to the power up state. 

A * Set line spacing in 1/72" increments. 

C * Set form length in 1/6" increments. 

Set internal printer tabs. 

E Turn on emphasized mode. 

F Turn off emphasized mode. 

G Turn on double strike mode. 

H Turn off double strike mode. 

K * 60 dots per inch graphics lead-in. 

L * 120 dots per inch graphics lead-in. 

"'Cl N * Set auto skip over top of form mode. 

"'Cl 0 Turn off auto skip over top of form mode. 

"'Cl Q * Set the printer width in columns. 

Command codes are printable: e.g. ""'CIA" or ""'C'Al 

* - These are followed by parameters, usually 
not printable. For these commands place your command 
code and options inside the brackets: 
e g. PRINT ""'C'C,12T* 

See your GRAFTRAX manual for function details. 




COr-IMEAlMD CHAFtTT 
EPSON with GRAFTRAX 
Printer Type 1 

DOT GRAPHICS <LF * .1065**, 8 dots) 

Dot format: 8 dots per character 

Dot spacing: 72 dots/** printhead spacing 
216 dots/** vert, addressing 
60 dots/** horis. 

120 dots/** horis. compressed 

Page format: 8** h 10** » 960 h 2160 dots 

13** K 10** =: 1560 H 2160 dots 

GRAY SCALE <LF = .0787**, 6 dots) 

Pixel sise: 5 dots wide x 3 dots high 

Coding: Each byte prints 2 pixels 

(5 wide X 6 high rectangle) 

SOFT-FONT (LF « .1666**, 6 LPI) 

Options: Compressed, Inverse 

Char. Width: .1333** (.0666** compressed) 

TEXT PRINTING <LF * .1666**, 6 LPI) 

Sizes: .06**, .1, .12, .2 

Size Command: Takes effect immediately 

Emphasize enlarges .06** and .12** chars. 

TEXT SCREEN PRINT 

Standard: Screen font & spacing 

Options: Inverse, Text font & spacing 




COMMAlslD CUE A Ft TT 
EPSON Type II, 82, MX-lOO 
Printer Type 0 

USEFUL ESCAPE COMMANDS 

0 Set 8 lines per inch vertical spacing. 

2 Set 6 lines per inch vertical spacing. 

"□A * Set line spacing in 1/72** increments. 

C * Set form length in 1/6** increments. 

D Set internal printer tabs. 

E Turn on emphasized mode. 

□ F Turn off emphasized mode . 

G Turn on double strike mode. 

H Turn off double strike mode. 

K * 60 dots per inch graphics lead-in. 

L * 120 dots per inch graphics lead-in. 

N * Set auto skip over top of form mode. 

0 Turn off auto skip over top of form mode. 

Q * Set the printer width in columns. 

Command codes are printable: 
e.g. PRINT **'^nA** or PRINT **"'C'A]** 

* - These are followed by parameters, usually 
not printable. For these commands place the command 
code and options inside the brackets: 
e.g. PRINT **"'C'C,12r* 

See your Epson manual for function details. 




<3 0 mm: AMD CHART 
EPSON Type II, 82, MX-lOO 
(Without GRAFTRAX) 

Printer Type 0 

DOT GRAPHICS <LF = .1065“, 8 dots) 

Dot format: 8 dots per character 

Dot spacing: 72 dots/** vert. 

60 dots/** horis. 

120 dots/** horiz. compressed 

Page format: 8** k 10** = 960 k 720 dots 

13** K 10** « 1560 X 720 dots 



GRAY SCALE <LF = .0787**, 6 dots) 

Pixel size: 5 dots wide x 3 dots high 

Coding: Each byte prints 2 pixels 

<5 wide X 6 high rectangle) 



SOFT-FONT <LF « .1666**, 6 LPI) 

Options: Compressed, Inverse 

Char. Width: .1333** (.0666** compressed) 



TEXT PRINTING (LF = .1666**, 6 LPI) 

Sizes: .06**, .082, .1, .12, .16, .2 

Size Command: Takes effect immediately if lost 
a switch in or out of expanded, e.g. .1** to .2'*. 
Takes effect BEFORE the line otherwise. 



TEXT SCREEN PRINT 

Standard: Screen font & spacing 

Options: Inverse, Text font & spacing 




COr-tr-lAlslD CHART 
IDS Prism Printers 
Printer Type 5 

USEFUL ESCAPE COMMANDS 
"'G B Set Vertical Adv-1 

C Set Vertical Adv-2 

-'G D Set Vertical Adv-3 

'*'G E Set printer's vertical tabs 

"*G G Set absolute Horisontal Position 

'*'G H Set absolute Vertical Position 

"''G L Set form size 

"^G M Set absolute line position 

'*'G N Set horizontal character position 

"^G P Set intercharacter spacing 

"'^G Q Set ribbon color on color Prisms 

"^G R Set character font, Sprint Mode only 

Command codes are printable. Most commands 
require parameters, e.g. '"*'GB,8,$" 
to select 6 lines per inch. See your IDS 
manual for formats & details 

USEFUL BYTE COMMANDS 

'*'343 Turn on Teat Justify mode 

"S53 Turn off Teat Justify mode 

"'SI 63 Turn on Proportional Spacing mode 

Turn off Proportional Spacing mode 



S63 




COr-tMLAlsID CMARTT 
IDS Prism Printers 
Printer Type 5 

DOT GRAPHICS <LF = .0625”) 

Dot format: 7 dots printed per character 

HiRes print uses 6 dot spacing 

Dot spacing: 84 dots/” vert. 

84 dots/” hori*. 

Page format: 8” h 10” 672 a 840 dots 

13” K 10” = 1092 K 840 dots 

GRAY SCALE <LF = .0625”, 6 dots) 

Pixel size: 5 dots wide x 6 dots high 

Coding: Each byte prints 1 pixel. 

SOFT-FONT (LF * .1666”, 6 LPI) 

Options: Inverse 

Char. Width: .0952” 

TEXT PRINTING (LF « .1666”, 6 LPI) 

Sizes: 0.6”, .1, .12, .2, Proportional 

Size Command: Takes dfect inediatilr idia md. 

TEXT SCREEN PRINT 

Standard: Screen font & spacing 

Options: SoftFont with 7-dot character 

height . 




C OMCr-t AIMD CHAR.T 
NEC PC8023 & C.Itoh 8510 
Printer Type 7 

USEFUL ESCAPE COMMANDS 



'Ll £ Select forward line-feed direction 

'□ r Select Reverse line-feed direction 

$ Select alphanumeric character set 

'□ # Select internal graphics symbols 

'□ ! Select enhanced mode, text & graphics 
'□ " Clear enhanced mode 
S * Enter bit graphics mode 
A Set vertical spacing to 6 LPI 
B Set vertical spacing to 8 LPI 
T <N> Set vertical spacing to N/144‘* 

'Ll X Turn on Underline Mode 

'Ll Y Turn off Underline Mode 



Most command codes are printable: e.g. 

'"''□A" to select 6 LPI spacing. 

<N> will usually be a printable code. 

For example to set 12/144" vertical spacing: 
PRINT ""'□T12" 

* - Followed by parameters and data, not 
necessarily printable. For these commands 
place the function code and options 
inside the brackets: 

e.g. ""'C'S,'0,'0,'0, '5, 1,2,4,8,161". . . 

Hint: for bit graphics use the PKASO SuperRes 
command instead. 

See your printer manual for function details. 




COMMATsID CHART 
NEC PC-8023 & C.Itoh 8510 
Printer Type 7 

DOT GRAPHICS <LF = .1111**, 8 dots) 

Dot format: 8 dots per character 

Dot spacing: 72 dots/" printhead spacing 
144 dots/*' vert, addressing 
81 dots/" horis. 

133 dots/" horiz. compressed 

Page format: 8" z 10" = 1064 k 1440 dots 

GRAY SCALE <LF = .1042", 6 dots) 

Pixel size: 5 dots wide x 6 dots high 

Coding: Each byte prints 1 pixel 

SOFT-FONT <LF = .1666", 6 LPI) 

Options: Compressed, Inverse 

Char. Width: .1" <.06" compressed) 

TEXT PRINTING <LF * .1666", 6 LPI) 

Sizes: 0.06", .1, .12, .2 

Size Command: Takes effect immediately 

TEXT SCREEN PRINT 

Standard: Screen font & spacing 

Options: Inverse, Text font & spacing 




COMMAMD CHAFtT 
Okidata 82A and 83A Printers with 
Dot Addressable Graphics 
Printer Type 6 

USEFUL ESCAPE COMMANDS 

M * Direct line skip 

F * Set number of lines per page 

'*'□5 Reset top of form 

'*'□6 Select 6 lines per inch text 

8 Select 8 lines per inch text 

<N> Move paper up N/144** 
(Use in text mode only) 



Command codes are printable: 
e.g. or 

* - These are followed by parameters, 

e.g. '•"'□F22** sets 22 lines per page. 



See your Okidata manuals for more details. 




C Or-tMAlSlD CUE ART 
Okidata 82A and 83A Printers with 
Dot Addressable Graphics 
Printer Type 6 

DOT GRAPHICS <LF = .0833") 

Dot format: 7 dots printed per character 

HiRes print uses 6 dot spacing 

Dot spacing: 66 dots/" printhead spacing 
144 dots/" vert, addressing 
60 dots/" horis. 

(Note: 99 dots/" horis. in 16.5 CPI Size. 

Use this to change graphics, SoftFont width.) 

Page format: 8" x 10" 480 x 1440 dots 

13" X 10" * 816 X 1440 dots 



GRAY SCALE (LF » .0833", 6 dots) 
Pixel size: 5 dots wide x 6 dots high 

Coding: Each byte prints 1 pixel 



SOFT-FONT (LF = .1666", 6 LPI) 

Options: Inverse, also use the 16.5 CPI 

character Size for a 40% 
compression effect. 

Char. Width: .1333" (.0808" at 16.5 CPI) 



TEXT PRINTING (LF « .1666", 6 LPI) 

Sizes: .06", .1, .12, .2 

Size Command takes effect: Start of 

neit line if just a switch in or out of 
eipanded mode. Immediately otherwise 



TEXT SCREEN PRINT 

Standard: Present text font & spacing 

Options: SoftFont with 7-dot character height. 

(Use 16.5 CPI char size to 
compress print) 




